home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / olrdrs / yarn_068.zip / DOS4GW.DOC < prev    next >
Text File  |  1994-01-11  |  22KB  |  589 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                           DOS/4GW Configuration Guide
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                        WATCOM International Corporation
  44.  
  45.  
  46.  
  47.  
  48.                            Waterloo, Ontario, Canada
  49.  
  50.  
  51. 1 Configuring DOS/4GW
  52.  
  53.  
  54.      This chapter explains how to use the DOS4G environment variable to
  55.      suppress the banner that is displayed by DOS/4GW at startup.  It also
  56.      explains how to use the DOS16M environment variable to select the switch
  57.      mode setting, if necessary, and to specify the range of extended memory in
  58.      which DOS/4GW will operate.  DOS/4GW is based on Rational Systems' DOS/16M
  59.      16-bit Protected-Mode support; hence the DOS16M environment variable name
  60.      remains unchanged.
  61.  
  62. 1.1 Suppressing the DOS/4GW Banner
  63.  
  64.      The banner that is displayed by DOS/4GW at startup can be suppressed by
  65.      issuing the following command:
  66.  
  67.        set DOS4G=quiet
  68.  
  69.      Do not insert a space between DOS4G and the equal sign.  A space to the
  70.      right of the equal sign is optional.
  71.  
  72. 1.2 Changing the Switch Mode Setting
  73.  
  74.      In almost all cases, DOS/4GW programs can detect the type of machine that
  75.      is running and automatically choose an appropriate real- to protected-mode
  76.      switch technique.  For the few cases in which this default setting does
  77.      not work we provide the DOS16M DOS environment variable, which overrides
  78.      the default setting.
  79.  
  80.      Change the switch mode settings by issuing the following command:
  81.  
  82.        set DOS16M=value
  83.  
  84.      Do not insert a space between DOS16M and the equal sign.  A space to the
  85.      right of the equal sign is optional.
  86.  
  87.      The table below lists the machines and the settings you would use with
  88.      them.  Many settings have mnemonics, listed in the column "Alternate
  89.      Name", that you can use instead of the number.  Settings that you must set
  90.      with the DOS16M variable have the notation req'd in the first column.
  91.      Settings you may use are marked option, and settings that will
  92.      automatically be set are marked auto.
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.                                            Changing the Switch Mode Setting   1 Chapter 1
  103. -------------------------------------------------------------------------------
  104.  
  105. +-------+---------------+-------+----------+-----------------------------------+
  106. |       |               |       |Alternate |                                   |
  107. |Status |Machine        |Setting|Name      |Comment                            |
  108. +-------+---------------+-------+----------+-----------------------------------+
  109. |auto   |386/486 w/ DPMI|0      |None      |Set automatically if DPMI is active|
  110. |req'd  |NEC 98-series  |1      |9801      |Must be set for NEC 98-series      |
  111. |auto   |PS/2           |2      |None      |Set automatically for PS/2         |
  112. |auto   |386/486        |3      |386, 80386|Set automatically for 386 or 486   |
  113. |auto   |386            |INBOARD|None      |386 with Intel Inboard             |
  114. |req'd  |Fujitsu FMR-70 |5      |None      |Must be set for Fujitsu FMR-70     |
  115. |auto   |386/486 w/ VCPI|11     |None      |Set automatically if VCPI detected |
  116. |req'd  |Hitachi B32    |14     |None      |Must be set for Hitachi B32        |
  117. |req'd  |OKI if800      |15     |None      |Must be set for OKI if800          |
  118. |option |IBM PS/55      |16     |None      |May be needed for some PS/55s      |
  119. +-------+---------------+-------+----------+-----------------------------------+
  120.  
  121.      The following procedure shows you how to test the switch mode setting.
  122.  
  123.        1. If you have one of the machines listed below, set the DOS16M
  124.          environment variable to the value shown for that machine and specify a
  125.          range of extended memory.  For example, if your machine is an NEC
  126.          98-series, set DOS16M=1 @2M-4M.  See the section, "Fine Control of
  127.          Memory Usage" later in this chapter for more information about setting
  128.          the memory range.
  129.  
  130.             +--------------------+---------+
  131.             | Machine            | Setting |
  132.             +--------------------+---------+
  133.             | NEC 98-series      | 1       |
  134.             | Fujitsu FMR-60,-70 | 5       |
  135.             | Hitachi B32        | 14      |
  136.             | OKI if800          | 15      |
  137.             +--------------------+---------+
  138.  
  139.          Before running DOS/4GW applications, check the switch mode setting by
  140.          following this procedure:
  141.  
  142.        2. Run PMINFO and note the switch setting reported on the last line of
  143.          the display.  (PMINFO, which reports on the protected-mode resources
  144.          available to your programs, is described in more detail in the
  145.          chapter, "Utilities".)
  146.  
  147.          If PMINFO runs, the setting is usable on your machine.
  148.  
  149.        3. If you changed the switch setting, add the new setting to your
  150.          AUTOEXEC.BAT file.
  151.  
  152.      Note:  PMINFO will run successfully on 286 machines.  If your DOS/4GW
  153.      application does not run, and PMINFO does, check the CPU type reported on
  154.      the first line of the display.
  155.  
  156. 2   Changing the Switch Mode Setting                                                             Configuring DOS/4GW
  157. -------------------------------------------------------------------------------
  158.  
  159.      You are authorized (and encouraged) to distribute PMINFO to your
  160.      customers.  You may also include a copy of this section in your
  161.      documentation.
  162.  
  163. 1.3 Fine Control of Memory Usage
  164.  
  165.      In addition to setting the switch mode as described above, the DOS16M
  166.      environment variable enables you to specify which portion of extended
  167.      memory DOS/4GW will use.  The variable also allows you to instruct DOS/4GW
  168.      to search for extra memory and use it if it is present.
  169.  
  170. 1.3.1 Specifying a Range of Extended Memory
  171.  
  172.      Normally, you don't need to specify a range of memory with the DOS16M
  173.      variable.  You must use the variable, however, in the following cases:
  174.  
  175.        * You are running on a Fujitsu FMR-series, NEC 98-series, OKI
  176.         if800-series or Hitachi B-series machine.
  177.  
  178.        * You have older programs that use extended memory but don't follow one
  179.         of the standard disciplines.
  180.  
  181.        * You want to shell out of DOS/4GW to use another program that requires
  182.         extended memory.
  183.  
  184.      If none of these conditions applies to you, you can skip this section.
  185.  
  186.      The general syntax is:
  187.  
  188.        set DOS16M= [switch_mode] [@start_address [- end_address]] [:size]
  189.  
  190.      In the syntax shown above, start_address, end_address and size represent
  191.      numbers, expressed in decimal or in hexadecimal (hex requires a 0x
  192.      prefix).  The number may end with a K to indicate an address or size in
  193.      kilobytes, or an M to indicate megabytes.  If no suffix is given, the
  194.      address or size is assumed to be in kilobytes.  If both a size and a range
  195.      are specified, the more restrictive interpretation is used.
  196.  
  197.      The most flexible strategy is to specify only a size.  However, if you are
  198.      running with other software that does not follow a convention for
  199.      indicating its use of extended memory, and these other programs start
  200.      before DOS/4GW, you will need to calculate the range of memory used by the
  201.      other programs and specify a range for DOS/4GW programs to use.
  202.  
  203.      DOS/4GW ignores specifications (or parts of specifications) that conflict
  204.      with other information about extended memory use.  Below are some examples
  205.      of memory usage control:
  206.  
  207.  
  208.  
  209.  
  210.                                                Fine Control of Memory Usage   3 Chapter 1
  211. -------------------------------------------------------------------------------
  212.  
  213.      set DOS16M= 1 @2m-4m    Mode 1, for NEC 98-series machines, and use
  214.                              extended memory between 2.0 and 4.0MB.
  215.  
  216.      set DOS16M= :1M         Use the last full megabyte of extended memory, or
  217.                              as much as available limited to 1MB.
  218.  
  219.      set DOS16M= @2m         Use any extended memory available above 2MB.
  220.  
  221.      set